home *** CD-ROM | disk | FTP | other *** search
/ Joint Education Initiative / Joint Education Initiative.iso / programs / dos / gna / readme < prev    next >
Text File  |  1990-05-11  |  15KB  |  269 lines
  1. *****************************************************************************
  2.         GEOPHYSICS OF NORTH AMERICA   -   CD-ROM ACCESS SOFTWARE
  3. *****************************************************************************
  4.                    Release Version 1.00    -   May 25, 1990
  5. *****************************************************************************
  6.                       National Geophysical Data Center
  7.                       NOAA / NESDIS / NGDC
  8.                       Mail Code E/GC
  9.                       325 Broadway
  10.                       Boulder, CO 80303
  11. ***************************************************************************** 
  12.  
  13.   for software assistance call John Kinsfather (303) 497-6404,  FTS 320-6404 
  14.  
  15. ***************************************************************************** 
  16. Version 1.10 notes 
  17.    1. The maximum and minimum DNAG Gravity values have been corrected.
  18.       The previous incorrect values caused some very high or very low
  19.       values to display as black colored "no data" values.
  20.    2. When doing a Screen Restore function, all bit mapped (*.BMP) images
  21.       that were previously saved in the current working directory will be
  22.       displayed in a list.  Position the highlight bar on the desired
  23.       image to restore and then press Enter.  If the file is located in
  24.       another directory, then type in the complete path name.
  25.    3. Some images being displayed on the screen and/or output to disk
  26.       were offset by one row or one column.  These offsets have been
  27.       corrected.
  28.    4. The Value (^V) and Profile (^P) functions now display moving values
  29.       of the base image file for the cursor position.
  30.    5. Abnormal spikes on the histogram in the new palette section have been 
  31.       eliminated.
  32.    6. The image area limits can now be typed in with 3 decimal places to
  33.       be consistent throughout the software.
  34.    7. The file "contour.h" is now included on the software diskettes for
  35.       reference as specified in the .DOC files on the CD-ROM.
  36. Version 1.00 notes  September 27, 1989
  37.    1. The format of the label files (suffix .LBL) has been extensively
  38.       modified.  Old format label files are not compatible with this
  39.       version of the program.
  40.    2. Users may select their own image files from the VIEW Image Select menu
  41.       if they are rectangular arrays of 16 bit integer data.  A label (.LBL)
  42.       file must first be created to describe the file parameters.  The utility
  43.       program MAKELBL will prompt you for the required information and
  44.       create the label file.  MAKELBL can be run from the DOS prompt or it
  45.       may be called up from the utilities menu of the main GNA program menu.
  46.    3. The cursor latitude and longitude are displayed on screen while in
  47.       both the VALUE ( Ctrl-V ) and PROFILE (Ctrl-P ) modes.
  48.    4. Geographic grid lines are displayed with the Ctrl-G function only if
  49.       selected in the BOUNDARIES menu.
  50.    5. The image title is automatically displayed above the the color scale bar
  51.       when F3 is pressed while an image is on the screen.
  52.    6. Profile images can now be saved to EGA bit mapped files (.BMP extension)
  53.       using the SAVE (Ctrl-S) function while viewing profiles.
  54.    7. The utility program SHOW is available for displaying a series of image
  55.       files (extension .BMP) in a slide show type of presentation on an EGA
  56.       graphics screen.  This is a stand alone program that may be run from the
  57.       DOS prompt as follows :
  58.          SHOW Image1 Image2 ...
  59.       Note that the files to be displayed must have the saved bit map 
  60.       extension (.BMP) but that the extension must not be entered on the
  61.       command line.  This program may also be executed by selecting it from
  62.       the utilities menu of the main GNA program menu.
  63.    8. A TUTORIAL is now provided as part of the GNA system.  This is callable
  64.       from the main GNA menu.  It normally takes about 15 minutes to go 
  65.       through the tutorial at which point most users are then able to run
  66.       the GNA system without referring to the user manual.  The tutorial files
  67.       take up about 1 megabyte of space on the software diskettes.  If you
  68.       do not have sufficient space for it or want to remove it after viewing
  69.       it once, delete all files with a .DBD extension from the directory that
  70.       includes the GNA software.      
  71.  
  72. Version 0.70 notes
  73.    1. The GNA software uses L as the default CD-ROM drive letter.  If your
  74.       CD-ROM driver software (Microsoft Extensions, Ref. Tech. Standard File
  75.       Manager, etc. ) uses other than L, you may change the GNA default by
  76.       issuing a DOS SET command prior to executing GNA.  For example, if you
  77.       want the CD-ROM to be drive P :
  78.          > SET CDROMDRIVE=P
  79.          > GNA
  80.    2. The keyboard + and - keys are now interchangeable in function with the
  81.       keypad + and - keys
  82.    3. The color bar is now displayed on a screen image with F3.  A second F3 
  83.       or Esc will clear the color bar.  To save the color bar as part of your
  84.       image, press Enter after displaying the color bar with F3.
  85.    4. The color palette used to create an image is now saved with a screen
  86.       save command and automatically restored with screen restore
  87.    5. The view menu screen was modified to clear selected data sets
  88.    6. Output files are now all written to the default working directory
  89.       or to the selected output directory path as specified by the user
  90.    7. Control Value (Ctrl-V) function changed.  After moving the cursor to
  91.       desired location and pressing Enter, the point value information will
  92.       be displayed as before.  Any key will clear the cursor and restore the
  93.       screen.  The next time that Ctrl-V is pressed, the cursor will appear at
  94.       its previous location.
  95.    8. The screen should be restored to the correct video mode on normal exit
  96.       from the program.  Previously the screen would sometimes be blank until
  97.       you entered a command such as CLS or MODE CO80
  98.  
  99.  
  100.                              Getting Started
  101.  
  102.  
  103. Setting Up Your Computer
  104.  
  105. Any IBM PC/AT (286 or 386) or compatible personal computer with a EGA
  106. graphics board and a CD-ROM reader can operate with this software. 
  107. NGDC uses CD-ROM drives made by Hitachi and SONY, with controller
  108. board, connecting cable, and applications software by Reference
  109. Technology Inc.  This applications software is a standard file manager
  110. (STDFMAN) that interacts with the resident PC Disk Operating System
  111. (DOS) to make the CD-ROM drive appear as a read-only disk drive. 
  112. Microsoft extensions to DOS are also used on some systems.  These
  113. readers are used with a variety of PCs, AT compatibles, and 80386
  114. systems running at speeds up to 25 MHz.  Various EGA/VGA graphics
  115. boards are used at NGDC.  Any card with a standard EGA mode is
  116. adequate.
  117.   
  118. A single, high-density floppy disk drive and 3 megabytes of hard disk
  119. space are required to load and execute the software.  A large-capacity
  120. hard disk is needed if large files are to be copied from the CD, or if
  121. many screen images are to be saved.  We recommend using a PC/AT with
  122. at least 640K RAM and a 20 megabyte hard disk.  
  123.  
  124. The Geophysics of North America software requires 450 kilobytes of
  125. free RAM after loading the CD-ROM access software (Microsoft, Reference
  126. Technology, etc.).  The amount of available RAM can be checked by
  127. issuing the DOS command CHKDSK.  Depending on the software configurations
  128. for your PC, you may not have 450 kbytes available even though there is 
  129. 640 kbytes or more installed.  This can often be corrected by altering
  130. parameters in your CONFIG.SYS file, AUTOEXEC.BAT file, or in STDFMAN.EXE .
  131. Reducing the number of assigned buffers and files in CONFIG.SYS will free
  132. up some RAM but a minimum of 10 files and 10 buffers are recommended. 
  133. The program will not run or the run will lock up with too low a DOS file
  134. number.  Also, the I/O can be very slow with too few buffers.  
  135. STDFMAN.EXE (Reference Technology's Standard File Manager software for
  136. CD-ROM) uses a default of 4 buffers of 5,000 bytes each.  The recommended 
  137. values for use with the GNA software are 1 buffer (ndbuf=1) and buffer size
  138. 16,000 (dbsiz=16000).  Other ways to free up RAM are to remove from CONFIG.SYS
  139. any device drivers not needed while running the GNA software and by removing
  140. from AUTOEXEC.BAT any resident software that gets loaded automatically at
  141. boot time. 
  142. Be sure to reboot your PC after making any of the above changed and before
  143. running the GNA software.
  144.  
  145. There are many possible PC, EGA graphics board, and CD-ROM reader 
  146. configurations; some trial-and-error may be necessary to get a
  147. compatible configuration.  This may require restrapping the CD-ROM
  148. interface board to change the I/O address and/or interrupt; the driver
  149. software will then have to be modified to match the hardware con-
  150. figuration.  A special AUTOEXEC.BAT and/or CONFIG.SYS file may be
  151. needed on some PCs.  
  152.  
  153. Anyone who purchases a personal computer, CD-ROM reader, and supporting
  154. hardware and software is advised to check how these will work together
  155. as a system.  Each PC can present a slightly different problem to be
  156. solved before the complete system works successfully. We have no
  157. experience with using these devices with any PCs other than IBM
  158. compatibles that operate under DOS version 3.0 or higher (3.XX or
  159. 4.xx). 
  160.  
  161. Using the Compact Disc
  162.  
  163. The Geophysics of North America compact disc contains about 588
  164. megabytes (588 million characters) of data and information compiled
  165. from many different source tapes available at NGDC and the World Data
  166. Center A for Solid Earth Geophysics (both in Boulder, Colorado).  The
  167. data are on the CD-ROM in the ISO 9660 standard format. Mastering of
  168. the CD-ROM disc and replicating the copies were done by Discovery
  169. Systems, Inc., Dublin, Ohio.
  170.  
  171. Handle the CD-ROM carefully to avoid damage.  Dust, scratches, ink,
  172. paint, and fingerprints may obscure some of the data.  Given careful
  173. handling, expect at least a 10-year lifetime for the data disc.      
  174.       
  175.  
  176. Loading Access Software
  177.  
  178. The access software is provided on high-density (1.2 megabyte) 5.25"
  179. floppy diskettes or high-density (1.44 megabyte) 3.5" diskettes. 
  180. Detailed documentation for the access software may be found in the
  181. README file contained on the floppy diskettes.  Installation
  182. instructions can also be found in the README file on the diskettes.  
  183.  
  184.      1.    Create a subdirectory to hold the access software (i.e., MKDIR
  185.       C:\GNA)
  186.  
  187.      2.    Change your directory to the newly created subdirectory (i.e.,
  188.       CD C:\GNA)
  189.  
  190.      3.    Insert the access software diskette in the floppy drive (i.e.,
  191.       drive " A ")
  192.  
  193.      4.    Copy all the files from the diskette to the hard disk (i.e. COPY
  194.       A:*.*)
  195.  
  196.      5.    Remove the floppy diskette from the diskette drive.
  197.  
  198.      6.    Repeat steps 3 - 5 if you received the software on more than one
  199.       diskette.
  200.  
  201.      7.    Add the directory name that you created in step 1 to your DOS
  202.       search path.  This will require you to edit your AUTOEXEC.BAT
  203.       file or other .BAT file where you store your search path.  The
  204.       new directory name may be inserted anywhere in the path, but
  205.       normally at the end (i.e., C:\; C:\DOS; C:\BIN; .....; C:\GNA).
  206.  
  207.      8.    Be sure that all CD-ROM reader software (provided with the CD
  208.       reader) is loaded into the directory you created in step 2, or
  209.       another directory on the PC's DOS search path.  This can be
  210.       either Reference Technology "STDFMAN" or a Microsoft extension
  211.       to DOS.  The CD-ROM can then be accessed from any other directory
  212.       or subdirectory.  
  213.  
  214. WARNING: STDFMAN may crash if Terminate and Stay Resident (TSR)
  215. utilities are loaded first (e.g., Window DOS).  The error message may
  216. say "FLOATING POINT NOT LOADED."  STDFMAN should be called from
  217. AUTOEXEC.BAT before anything else gets loaded.
  218.  
  219.      9.    Place the CD-ROM into the reader unit, and power it on.
  220.  
  221.     10.    With the CD-ROM loaded into the reader unit, enter the command
  222.       <STDFMAN> (if this was used) to execute the standard file manager
  223.       program.  [Note:  The drive should not be opened when the "busy"
  224.       light is on.]
  225.  
  226.     11.    Execute the software from a separate directory other than the
  227.       directory created in step 1.  To begin execution, enter the
  228.       command <GNA>.
  229.   
  230.     12.    The CD-ROM can also be a direct data source.  Those who are able
  231.       to create their own access programs may choose to do this in
  232.       order to use the few parameters on the CD that are not accessed
  233.       by some of the standard programs provided.  While some DOS
  234.       commands work on the CD-ROM drive and its contents, a few do not
  235.       (e.g.  <DEL>  or <WRITE>).   This is explained in documentation
  236.       supplied with the CD-ROM drive.  
  237.  
  238. Entering <DIR> causes the monitor to display the subdirectories into
  239. which the compact disc is divided.  Each contains further
  240. subdirectories accessed by entering  <CD subdirectory name>.  Refer
  241. to the tree-structure diagram in the Technical Specifications section
  242. for more information on the directory structure.
  243.  
  244. The access software serves two primary purposes -- to support data
  245. retrieval from the compact disc and to provide a facility for a graphic
  246. "quick-look" at the data.  The software emphasizes extracts of
  247. latitude, longitude, and geophysical parameters from the archival
  248. portion of the disc, all of which are stored in an ASCII format.  The
  249. quick-look facility emphasizes screen displays of data images (e.g.,
  250. color raster representations), data contours, cross sections, and value
  251. postings.  Data supporting the display software are generally derived
  252. data sets, stored in binary files on the disc.
  253.  
  254. Some corrections to the compact disc data may eventually be provided
  255. on the access software diskette in a manner which should be transparent
  256. to the casual user.  In other words, the user of the access software
  257. will be unaware that some corrected data values are actually on the
  258. diskette instead of the compact disc.
  259.  
  260. The access software will be periodically updated; therefore, the user
  261. should reference all inquiries to a specific release version number
  262. (which appears in the title). 
  263.  
  264.  
  265. For Additional Help
  266.  
  267. If you have technical questions about the CD-ROM, the access software,
  268. or equipment used with the disc,  please contact John O. Kinsfather
  269. [303-497-6404 or FTS 320-6404] or Carl Abston [303-497-6276].